home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 002 / autosave.arc / AUTOSAVE.DOC next >
Encoding:
Text File  |  1986-12-10  |  11.4 KB  |  311 lines
  1.  
  2.  
  3. AUTOSAVE 1.0  Documentation 
  4. (C) Copyright 1986 Biologic Corp; ALL RIGHTS RESERVED 
  5.  
  6. Biologic Corp. 
  7. P.O. Box 1267 
  8. Manassas, Virginia 
  9. 22110 
  10.  
  11.  
  12.  
  13. INTRODUCTION 
  14.  
  15. Autosave helps you avoid losing your current worksheet or
  16. document due to power failure or other mishap by automatically
  17. saving it at regular time intervals.
  18.  
  19.  
  20.  
  21. How It Works 
  22.  
  23. When started, Autosave remains resident in memory as you use your
  24. spreadsheet program or word processor.  After a few minutes, it
  25. waits for a moment of keyboard inactivity and automatically
  26. enters the keystrokes necessary to save your file.  Autosave
  27. doesn't do anything else.  Your program interprets the keystrokes
  28. (just as if you had entered them yourself), saves the file, and
  29. returns you to the point where you left off.  Autosave continues
  30. to save your work every few minutes until you exit the program. 
  31.  
  32.  
  33.  
  34. Requirements 
  35.  
  36. Autosave is compatible with almost all programs.  It's flexible
  37. because it doesn't save your file; it enters the keys that
  38. instruct your spreadsheet or word processor to save a file.  When
  39. starting Autosave, you must tell it what keystrokes will save
  40. your document and that sequence of keys must work at any time in
  41. the program. 
  42.  
  43. Autosave works best when used with a hard disk.  Since a file can
  44. be written to a hard disk relatively quickly, "autosaving" your
  45. file every few minutes shouldn't be an inconvenience.  Floppy
  46. drives are much slower, though, and it may be better to manually
  47. save your work only when you feel it's necessary. 
  48.  
  49.  
  50. Registration 
  51.  
  52. Autosave is distributed as User Supported Software.  Please make
  53. copies of the unregistered version of this program and share it
  54. with others.  If you find it useful, we ask that you contribute
  55. $25.  Contributors will receive a registered version of Autosave
  56. that has more capabilities and all 'C' and assembly source code
  57. files with instructions on compiling and linking. 
  58.  
  59. We encourage contributions by providing quality support now and
  60. in the future.  Our products are revised continually to correct
  61. bugs and to introduce new features.  The next updated version
  62. will be mailed to registered users free of charge; all other
  63. updates can be obtained for $10 to cover the cost of postage,
  64. etc. 
  65.  
  66. In addition, we're available to answer questions from registered
  67. users by phone.  Please call us if you're having problems getting
  68. Autosave to work or if you'd like to discuss ways of improving
  69. its performance. 
  70.  
  71.       (Note: Some capabilities of the registered version are not
  72.       supported in the unregistered version.  Differences will be
  73.       noted in the following sections.) 
  74.  
  75.  
  76. STARTING AUTOSAVE 
  77.  
  78. Format 
  79.  
  80. Begin by typing "autosave" followed by required and optional
  81. parameters.  The last entry on the command line should be the
  82. command you normally use to start your spreadsheet program or
  83. word processor, including the name of the file to be edited, if
  84. appropriate. 
  85.  
  86.       Example 
  87.  
  88.       If you normally type "123" to start Lotus 123, "123" should
  89.       be entered at the end of the Autosave command line: 
  90.  
  91.       AUTOSAVE (parameters) 123 
  92.  
  93.       (Note: The file name entered at the end of the Autosave
  94.       command must be a COM or EXE file; it cannot be a BAT
  95.       file.) 
  96.  
  97. Parameters begin with a hyphen and a lower-case letter; the
  98. corresponding upper-case letter will have no effect.  All
  99. parameters are required, unless indicated as optional, and can be
  100. entered in any order. 
  101.  
  102. The complete format for the command line is: 
  103.  
  104. AUTOSAVE -kn[,n...,*,n...] [-f<name>] [-in] [-tn] [-u] <program> 
  105.  
  106.       (Note: The character n represents any allowable number- see
  107.       below.) 
  108.  
  109.  
  110.  
  111. Parameters 
  112.  
  113. -k    This parameter tells Autosave the sequence of keys that
  114.       save a file.  Keys are specified using numbers (see table
  115.       in appendix), and separated by commas.  An asterisk can be
  116.       used to indicate the point at which the file name, as
  117.       specified by the -f parameter, is entered. 
  118.  
  119.       Example 
  120.  
  121.       With 123, you save a file by typing /FS, entering the file
  122.       name, and pressing ENTER.  If the file already exists, you
  123.       also have to press R to confirm the save.  Listed below is
  124.       a sequence of keys to save a file in 123: 
  125.  
  126.       47,70,83,*,13,82 
  127.  
  128.  
  129.       To ensure that this sequence of keystrokes will save a file
  130.       even when in a menu, a few ESCs are added to the beginning.
  131.       In addition, an ESC is appended to the end to erase the R
  132.       that will be displayed if the file does not already exist: 
  133.  
  134.       27,27,27,27,27,27,47,70,83,*,13,82,27 
  135.  
  136.       The command to start 123 with autosave is shown below: 
  137.  
  138.       AUTOSAVE -k27,27,27,27,27,27,47,70,83,*,13,82,27 -fsave 123 
  139.  
  140.       (note: Use a batch file to avoid entering this command
  141.       every time you start 123.  See the section on batch files
  142.       below.) 
  143.  
  144.       Example 
  145.  
  146.       When using PC-Write, you can save your file by pressing F1
  147.       and then F3.  Use the command below to automatically save
  148.       your file while using PC-Write: 
  149.  
  150.       AUTOSAVE -k315,317 ed <filename> 
  151.  
  152.       (note: It's important to use a key sequence that works at
  153.       all times regardless of what you're doing in your program.
  154.       This may take a little experimentation and testing.
  155.       Registered users can contact us for help in getting
  156.       Autosave to work properly.) 
  157.  
  158. -f    (optional) 
  159.       Specifies the file name to be included in the key sequence
  160.       in place of the asterisk.  In the example for 123, above,
  161.       the file is saved as "save.wk1".  If the list of keys
  162.       specified by -k includes an asterisk, this parameter is
  163.       required. 
  164.  
  165. -i    (optional) 
  166.       Sets the length of idle time (in seconds) that must occur
  167.       before Autosave will save a file.  If you set the idle time
  168.       to 20, your file will be saved after you have not pressed a
  169.       key for at least 20 seconds.  This is useful if you do not
  170.       want to be interrupted while typing or, for example, when
  171.       selecting a Lotus 123 command.  If you do not indicate an
  172.       idle time, Autosave will use a default time of 30 seconds. 
  173.  
  174.       Example 
  175.  
  176.       AUTOSAVE -i20 (other parameters) 
  177.  
  178.       (Note: this option is supported in the registered version
  179.       only.) 
  180.  
  181.  
  182. -t    (optional) 
  183.       Sets the minimum time interval (in minutes) between saves.
  184.       Autosave will wait this length of time before checking for
  185.       sufficient idle time to save the file.  If you do not
  186.       specify a minimum time interval, a default of 5 minutes
  187.       will be used. 
  188.  
  189.       Example 
  190.  
  191.       With idle time set to 20 and the minimum time interval set
  192.       to 0, your work will be saved every time your keyboard is
  193.       idle for 20 seconds.  If you set the idle time to 20 and
  194.       the minimum time interval to 10, your work will be saved
  195.       after an idle time of 20 seconds, provided at least 10
  196.       minutes has passed since the last save. 
  197.  
  198.       AUTOSAVE -i20 -t10 (other parameters)
  199.  
  200.       (Note: this option is supported in the registered version
  201.       only.) 
  202.  
  203. -u    (optional) 
  204.       Displays help screen. 
  205.  
  206.  
  207.  
  208. Using a Batch File 
  209.  
  210. Obviously, you won't want to type the entire Autosave command
  211. line every time you use your spreadsheet program or word
  212. processor.  A simple solution is to set up a one line batch file
  213. with the Autosave command in it for each program.  Give it a
  214. short name, like "1.bat" for Lotus 123, and put it in the
  215. directory with your program files.  Be sure to put "autosave.exe"
  216. in this directory also, or include the directory that has
  217. Autosave in the PATH string (read about the PATH command in your
  218. DOS manual). 
  219.  
  220. The appendix has sample batch files for a few popular programs. 
  221.  
  222.  
  223. USING AUTOSAVE 
  224.  
  225. Although Autosave writes your file to disk every few minutes, you
  226. should save your work, as you normally do, when exiting.
  227. Autosave does not automatically save your file when you exit a
  228. program. 
  229.  
  230. In the example for Lotus 123 discussed previously, Autosave saves
  231. the worksheet under the name "save.wk1" in the default directory.
  232. The worksheet you are working on may have any name, "foo.wk1" for
  233. example.  If for some reason you lose your work, "save.wk1" will
  234. contain the most recent copy of your worksheet.  Just retrieve
  235. it, and save it as "foo.wk1". 
  236.  
  237.  
  238. APPENDIX 
  239.  
  240. Key Codes 
  241.  
  242. Code  Key      Code  Key     Code  Key          Code  Key
  243.  
  244.    8  Backspace  75  K        306  Alt-M         366  Alt-F7
  245.    9  Tab        76  L        315  F1            367  Alt-F8
  246.   13  Enter      77  M        316  F2            368  Alt-F9
  247.   27  Esc        78  N        317  F3            369  Alt-F10
  248.   32  Space      79  O        318  F4            373  Ctrl-End
  249.   33  !          80  P        319  F5            374  Ctrl-PgDn
  250.   34  "          81  Q        320  F6            375  Ctrl-Home
  251.   35  #          82  R        321  F7            376  Alt-1
  252.   36  $          83  S        322  F8            377  Alt-2
  253.   37  %          84  T        323  F9            378  Alt-3
  254.   38  &          85  U        324  F10           379  Alt-4
  255.   39  '          86  V        327  Home          380  Alt-5
  256.   40  (          87  W        328  Cursor Up     381  Alt-6
  257.   41  )          88  X        329  PgUp          382  Alt-7
  258.   42  *          89  Y        331  Cursor Left   383  Alt-8
  259.   43  +          90  Z        333  Cursor Right  384  Alt-9
  260.   44  ,          91  [        335  End           385  Alt-0
  261.   45  -          92  \        336  Cursor Down   386  Alt-Hyphen
  262.   46  .          93  ]        337  PgDn          387  Alt-=
  263.   47  /          94  ^        338  Ins           388  Ctrl-PgUp
  264.   48  0          95  _        339  Del           513  Ctrl-A
  265.   49  1          96  `        340  Shift-F1      514  Ctrl-B
  266.   50  2         272  Alt-Q    341  Shift-F2      515  Ctrl-C
  267.   51  3         273  Alt-W    342  Shift-F3      516  Ctrl-D
  268.   52  4         274  Alt-E    343  Shift-F4      517  Ctrl-E
  269.   53  5         275  Alt-R    344  Shift-F5      518  Ctrl-F
  270.   54  6         276  Alt-T    345  Shift-F6      519  Ctrl-G
  271.   55  7         277  Alt-Y    346  Shift-F7      520  Ctrl-H
  272.   56  8         278  Alt-U    347  Shift-F8      521  Ctrl-I
  273.   57  9         279  Alt-I    348  Shift-F9      522  Ctrl-J
  274.   58  :         280  Alt-O    349  Shift-F10     523  Ctrl-K
  275.   59  ;         281  Alt-P    350  Ctrl-F1       524  Ctrl-L
  276.   60  <         286  Alt-A    351  Ctrl-F2       525  Ctrl-M
  277.   61  =         287  Alt-S    352  Ctrl-F3       526  Ctrl-N
  278.   62  >         288  Alt-D    353  Ctrl-F4       527  Ctrl-O
  279.   63  ?         289  Alt-F    354  Ctrl-F5       528  Ctrl-P
  280.   64  @         290  Alt-G    355  Ctrl-F6       529  Ctrl-Q
  281.   65  A         291  Alt-H    356  Ctrl-F7       530  Ctrl-R
  282.   66  B         292  Alt-J    357  Ctrl-F8       531  Ctrl-S
  283.   67  C         293  Alt-K    358  Ctrl-F9       532  Ctrl-T
  284.   68  D         294  Alt-L    359  Ctrl-F10      533  Ctrl-U
  285.   69  E         300  Alt-Z    360  Alt-F1        534  Ctrl-V
  286.   70  F         301  Alt-X    361  Alt-F2        535  Ctrl-W
  287.   71  G         302  Alt-C    362  Alt-F3        536  Ctrl-X
  288.   72  H         303  Alt-V    363  Alt-F4        537  Ctrl-Y
  289.   73  I         304  Alt-B    364  Alt-F5        538  Ctrl-Z
  290.   74  J         305  Alt-N    365  Alt-F6
  291.  
  292.  
  293. Sample Batch Files 
  294.  
  295. Lotus 123 
  296.  
  297. AUTOSAVE -k27,27,27,27,27,27,47,70,83,*,13,82,27 -fsave 123 
  298.  
  299.  
  300.  
  301. PC-Write 
  302.  
  303. AUTOSAVE -k315,317 ed <filename> 
  304.  
  305.  
  306.  
  307. Symphony 
  308.  
  309. AUTOSAVE -k27,27,27,27,27,27,323,70,83,323,27,*,13,89,27 -fsave symphony 
  310.  
  311.